package com.edu.exam.entity.curriculum.questionbank;

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.hibernate.annotations.Comment;
import org.springframework.data.annotation.CreatedDate;
import org.springframework.data.jpa.domain.support.AuditingEntityListener;

import jakarta.persistence.*;
import jakarta.validation.constraints.NotNull;
import java.math.BigDecimal;
import java.time.LocalDate;
import java.time.LocalDateTime;

/**
 * 单选题使用统计实体类
 * 对应数据库表：sc_usage_statistics
 *
 * 根据B-02-03-03单选题管理子模块设计文档实现
 * 管理单选题的使用统计数据，包括使用次数、正确率、时间分布等。
 * 支持题目使用效果分析和质量改进建议。
 *
 * @author System
 * @version 1.0.0
 */
@Entity
@Table(name = "sc_usage_statistics")
@Comment("单选题使用统计表")
@EntityListeners(AuditingEntityListener.class)
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class SingleChoiceUsageStatistics {

    /**
     * 主键ID
     */
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id")
    private Long id;

    /**
     * 关联的单选题ID
     */
    @NotNull(message = "题目ID不能为空")
    @Column(name = "question_id", nullable = false)
    private String questionId;

    /**
     * 统计日期
     */
    @NotNull(message = "统计日期不能为空")
    @Column(name = "stat_date", nullable = false)
    private LocalDate statDate;

    /**
     * 当日使用次数
     */
    @NotNull(message = "使用次数不能为空")
    @Column(name = "usage_count", nullable = false)
    private Integer usageCount;

    /**
     * 当日正确次数
     */
    @NotNull(message = "正确次数不能为空")
    @Column(name = "correct_count", nullable = false)
    private Integer correctCount;

    /**
     * 当日错误次数
     */
    @NotNull(message = "错误次数不能为空")
    @Column(name = "incorrect_count", nullable = false)
    private Integer incorrectCount;

    /**
     * 当日正确率（0-1）
     */
    @Column(name = "accuracy_rate", precision = 5, scale = 4)
    private BigDecimal accuracyRate;

    /**
     * 平均答题时间（秒）
     */
    @Column(name = "average_time_seconds", precision = 8, scale = 2)
    private BigDecimal averageTimeSeconds;

    /**
     * 最快答题时间（秒）
     */
    @Column(name = "fastest_time_seconds", precision = 8, scale = 2)
    private BigDecimal fastestTimeSeconds;

    /**
     * 最慢答题时间（秒）
     */
    @Column(name = "slowest_time_seconds", precision = 8, scale = 2)
    private BigDecimal slowestTimeSeconds;

    /**
     * 答题时间中位数（秒）
     */
    @Column(name = "median_time_seconds", precision = 8, scale = 2)
    private BigDecimal medianTimeSeconds;

    /**
     * 答题时间标准差（秒）
     */
    @Column(name = "time_std_deviation", precision = 8, scale = 2)
    private BigDecimal timeStdDeviation;

    /**
     * 各选项选择次数（JSON格式，格式：{"1": 次数, "2": 次数, ...}）
     */
    @Column(name = "option_selection_counts", columnDefinition = "TEXT")
    private String optionSelectionCounts;

    /**
     * 各选项选择率（JSON格式，格式：{"1": 比率, "2": 比率, ...}）
     */
    @Column(name = "option_selection_rates", columnDefinition = "TEXT")
    private String optionSelectionRates;

    /**
     * 正确选项选择率
     */
    @Column(name = "correct_option_rate", precision = 5, scale = 4)
    private BigDecimal correctOptionRate;

    /**
     * 干扰项平均选择率
     */
    @Column(name = "distraction_avg_rate", precision = 5, scale = 4)
    private BigDecimal distractionAvgRate;

    /**
     * 最佳干扰项选择率（选择率最高的错误选项）
     */
    @Column(name = "best_distraction_rate", precision = 5, scale = 4)
    private BigDecimal bestDistractionRate;

    /**
     * 使用场景类型（EXAM-考试，PRACTICE-练习，QUIZ-测验，REVIEW-复习）
     */
    @Column(name = "usage_scenario", length = 20)
    private String usageScenario;

    /**
     * 难度感知评分（1-5分，基于实际使用情况）
     */
    @Column(name = "perceived_difficulty")
    private Integer perceivedDifficulty;

    /**
     * 题目质量评分（1-5分，基于使用反馈）
     */
    @Column(name = "quality_rating")
    private Integer qualityRating;

    /**
     * 反馈次数（学生对该题目的反馈数量）
     */
    @Column(name = "feedback_count")
    private Integer feedbackCount;

    /**
     * 平均反馈评分（1-5分）
     */
    @Column(name = "average_feedback_score", precision = 3, scale = 2)
    private BigDecimal averageFeedbackScore;

    /**
     * 相关知识点掌握度（0-1，基于答题正确率）
     */
    @Column(name = "knowledge_mastery", precision = 5, scale = 4)
    private BigDecimal knowledgeMastery;

    /**
     * 题目区分度（0-1，衡量题目对不同水平学生的区分能力）
     */
    @Column(name = "discrimination_index", precision = 5, scale = 4)
    private BigDecimal discriminationIndex;

    /**
     * 题目难度系数（0-1，基于实际答题情况）
     */
    @Column(name = "difficulty_index", precision = 5, scale = 4)
    private BigDecimal difficultyIndex;

    /**
     * 时间分布统计（JSON格式，按时间段统计答题数量）
     */
    @Column(name = "time_distribution", columnDefinition = "TEXT")
    private String timeDistribution;

    /**
     * 地区分布统计（JSON格式，按地区统计答题情况）
     */
    @Column(name = "region_distribution", columnDefinition = "TEXT")
    private String regionDistribution;

    /**
     * 用户类型分布统计（JSON格式，按用户类型统计）
     */
    @Column(name = "user_type_distribution", columnDefinition = "TEXT")
    private String userTypeDistribution;

    /**
     * 异常答题记录数（如答题时间过短、过长等）
     */
    @Column(name = "abnormal_answer_count")
    private Integer abnormalAnswerCount;

    /**
     * 统计扩展数据（JSON格式）
     */
    @Column(name = "extended_data", columnDefinition = "TEXT")
    private String extendedData;

    /**
     * 数据采集时间
     */
    @Column(name = "collection_time")
    private LocalDateTime collectionTime;

    /**
     * 数据更新时间
     */
    @Column(name = "update_time")
    private LocalDateTime updateTime;

    /**
     * 数据来源（SYSTEM-系统自动生成，MANUAL-手动录入，IMPORT-批量导入）
     */
    @Column(name = "data_source", length = 20)
    private String dataSource;

    /**
     * 数据版本
     */
    @Column(name = "data_version")
    private Integer dataVersion;

    /**
     * 创建人
     */
    @Column(name = "created_by", length = 50)
    private String createdBy;

    /**
     * 创建时间
     */
    @CreatedDate
    @Column(name = "create_time", nullable = false, updatable = false)
    private LocalDateTime createdTime;

    /**
     * 更新人
     */
    @Column(name = "updated_by", length = 50)
    private String updatedBy;

    /**
     * 更新时间
     */
    @Column(name = "updated_time")
    private LocalDateTime updatedTime;
}